home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / pascal / scenebl.exe / READ.ME < prev    next >
Text File  |  1993-01-16  |  10KB  |  209 lines
  1.                          SCENE BUILDER Version 1.01
  2.  
  3.           Copyright (C) 1993 by Jerry Rivers, All Rights Reserved
  4.  
  5. OVERVIEW:
  6.  
  7.    SceneBuilder is an exciting new way to do graphics in Turbo Pascal.
  8.  
  9.    SceneBuilder is similar to a "paint" program in that it allows you to
  10.    create colorful graphics pictures interactively, using keyboard and
  11.    mouse.  But it is unlike ANY paint program because SceneBuilder creates
  12.    a runnable Pascal source program which re-creates the graphics scene!
  13.  
  14.    SceneBuilder maintains a "display list" of all graphics objects
  15.    created, to allow such functions as re-draw and zoom.  The display list
  16.    is stored on disk with the extension "LST".  Pascal source programs use
  17.    the same file name, but with the standard "PAS" extension.
  18.  
  19.    This version of SceneBuilder is my first attempt at Turbo Pascal
  20.    graphics programming.  SceneBuilder was originally written for my
  21.    daughter, who is learning Pascal.  She wanted an easy way to build the
  22.    background scenery for graphics animation.  Two major design goals for
  23.    SceneBuilder were: use of standard Turbo Pascal BGI graphics, and the
  24.    ability to create a compilable source program of the resulting scene.
  25.  
  26.    I am interested in your comments, good or bad, with respect to
  27.    SceneBuilder's value and interest to you.
  28.  
  29. INSTALLATION:
  30.  
  31.    There is no fancy "install" program with SceneBuilder.  Just DOS COPY
  32.    the files on the installation disk to the hard disk directory of your
  33.    choice.  The files EGAVGA.BGI, GOTH.CHR, LITT.CHR, SANS.CHR, and
  34.    TRIP.CHR have been linked into SCENE.EXE so that SceneBuilder can be
  35.    run whether you have Turbo Pascal 6.0 or not (also gets around the
  36.    changes in Borland Pascal 7.0).  The "help" file SCENE.HLP must be in
  37.    the same directory as SCENE.EXE.
  38.  
  39. RUNNING SCENE BUILDER FROM DOS:
  40.  
  41.    From DOS, just type SCENE.  SceneBuilder will immediate start, showing
  42.    the "start-up" screen below:
  43.  
  44.                         SCENE BUILDER Version 1.01
  45.                              By Jerry Rivers
  46.  
  47.                  Copyright (C) 1993, All Rights Reserved
  48.  
  49.     - Context-sensitive help available: Press RIGHT mouse button
  50.       when over any menu item (except fill patterns and colors)
  51.     - Full help available: Select Help (?) icon or press "F1"
  52.     - Drawing tool, display, file, and fill pattern menu items
  53.       are selected with LEFT mouse button
  54.     - Drawing colors are selected with LEFT mouse button
  55.     - Fill colors are selected with RIGHT mouse button'
  56.  
  57.             Press Any Key Or Either Mouse Button To Begin
  58.                               ┌────────┐
  59.                               │   OK   │
  60.                               └────────┘ RUNNING SCENE BUILDER FROM WINDOWS 3.1:
  61.  
  62.    A Windows 3.1 PIF file is provided.  SCENE.PIF assumes that SCENE.EXE
  63.    is in the C:\PGMS subdirectory, where I keep all my executables and
  64.    Pascal units (TPUs).  Just use Window's PIFEDIT to edit SCENE.PIF to
  65.    suit your configuration.
  66.  
  67.    SceneBuilder MUST be run in full-screen mode under Windows. It will NOT
  68.    operate within a DOS window!
  69.  
  70. BUGS:
  71.  
  72.    There are no known bugs at this time in SceneBuilder.  Of course, there
  73.    are bugs, I just don't know about them.  So, as a "freeware" beta
  74.    tester, please let me know what bugs you find, as well as suggestions
  75.    to make SceneBuilder more useful
  76.  
  77.    I have found a couple of BGI graphics library bugs:
  78.  
  79.       -  If you try to draw a filled polygon (FillPoly) with Black as the
  80.          edge color, only the filled interior will be drawn.  This is
  81.          apparently a BGI bug dealing with edges in the background color,
  82.          which is Black by default.  FillPoly with other edge colors draw
  83.          and fill OK.
  84.  
  85.       -  Contrary to the Library Reference documentation, line styles do
  86.          NOT work with circles, ellipses, or arcs.  These are always drawn
  87.          with SolidLn styles.  If you've defined Dashed, Dotted, or
  88.          Centerline styles in SceneBuilder, your curves will still be
  89.          solid, but "round rectangles" will have their straight lines in
  90.          the selected line style.
  91.  
  92.       -  Some filled objects may not look the way you expect when zoomed
  93.          in.  This is a BGI limitation; if the flood fill origin is not
  94.          within the zoomed-in area, the BGI does not do the fill.
  95.  
  96. LIMITATIONS:
  97.  
  98.    SceneBuilder has been tested on the following computers:
  99.  
  100.    -  Epson 386SX, 4mb RAM, DOS 5.0, Windows 3.1, VGA
  101.       (development platform)
  102.    -  Lucky Goldstar 386/25, 4mb RAM, DOS 3.3, Windows 3.1, VGA
  103.    -  Lucky Goldstar 486/33, 16mb RAM, DOS 5.0, Windows 3.1, VGA
  104.    -  Gateway 2000 386/33, 4mb RAM, DOS 5.0, Windows 3.1, VGA
  105.  
  106.    SceneBuilder has the following data capacity:
  107.  
  108.    -  200 total display list items
  109.    -  200 total polygon points
  110.    -   50 total lines of text and comments
  111.  
  112. GRAPHICS:
  113.  
  114.    SceneBuilder is designed to work ONLY with standard 16-color 640 x 480
  115.    VGA graphics. It will work OK on a "super VGA" system, but only in
  116.    normal VGA mode.  SceneBuilder will NOT run on anything more or less.
  117. CONTENTS OF SCENE ZIP FILE:
  118.  
  119.    -  SCENE.EXE            SceneBuilder executable program
  120.    -  SCENE.HLP            Detailed help for using SceneBuilder.  A help
  121.                            screen is shown when either the Help (?) icon
  122.                            is selected or "?" typed.  SCENE.HLP can be
  123.                            copied to your printer for written docs.
  124.    -  SCENE.ICO            SceneBuilder Windows 3.1 icon
  125.    -  SCENE.PIF            Windows 3.1 PIF (Program Information File) for
  126.                            SceneBuilder.  This allows you to run SCENE.EXE
  127.                            under Windows 3.1.  You MUST modify SCENE.PIF
  128.                            to point to where you stored SCENE.EXE.
  129.    -  READ.ME              This file.
  130.    -  HOUSE.LST            Example scene of a house in winter
  131.    -  PC.LST               Example scene of a PC running SceneBuilder
  132.    -  SCHOONER.LST         Example scene of a schooner sailing ship
  133.    -  USA_FLAG.LST         Example scene of the USA flag
  134.    -  WIDGET.LST           Example scene of a 2-D blueprint drawing
  135.  
  136. COMMENTS, SUGGESTIONS, BRICK-A-BRACK:
  137.  
  138.    Please send me your comments, good or bad, through CompuServe mail or
  139.    notes in the Borland Pascal forum.  My ID is:
  140.  
  141.                                Jerry Rivers
  142.                                 71477, 2663
  143.  
  144.    This version of SceneBuilder is strictly "freeware" (although it is NOT
  145.    public domain!).  I am contemplating offering SceneBuilder as
  146.    shareware, complete with source.  So, I'm interested in your views on
  147.    that: is SceneBuilder a worthy shareware program?
  148.  
  149.    From time to time, I'll upload enhanced versions or versions with
  150.    identified bugs repaired.  Your help in finding elusive bugs is
  151.    appreciated.  Please post details of what you were doing just prior to
  152.    seeing the bug so I can try to recreate the situation.  If necessary,
  153.    upload the *.LST file you had trouble with.
  154.  
  155.    I'm also very interested in your comments regarding suitability to
  156.    task, user friendliness, general usefulness, etc.  If you've got some
  157.    ideas that would make SceneBuilder better, please pass them along.
  158.  
  159.                     Thank you for trying SceneBuilder!
  160.  
  161.  
  162.                              January 16, 1993
  163.  
  164.  
  165.          ----------------end-of-author's-documentation---------------
  166.  
  167.                          Software Library Information:
  168.  
  169.                     This disk copy provided as a service of
  170.  
  171.                            Public (software) Library
  172.  
  173.          We are not the authors of this program, nor are we associated
  174.          with the author in any way other than as a distributor of the
  175.          program in accordance with the author's terms of distribution.
  176.  
  177.          Please direct shareware payments and specific questions about
  178.          this program to the author of the program, whose name appears
  179.          elsewhere in  this documentation. If you have trouble getting
  180.          in touch with the author